home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 031a / restls.zip / READ_ME.ICN < prev    next >
Text File  |  1991-11-23  |  16KB  |  279 lines

  1. ** How to use Mr. Icon **
  2.  
  3. This utility will allow you to scan through an .EXE or .DLL file and view
  4. all icons present.  Icons are not divided into icon groups, so you might
  5. see multiple versions of the same icon (these will be icons used for different
  6. resolution devices).  By using the right arrow button, the next icon will be
  7. displayed and by using the left arrow button the previously viewed icon can
  8. be brought back and displayed.  The right and left arrow keys of the keyboard
  9. can also be used to view icons.  The Page Up and Page Down keys can be used
  10. to move between icon groups, Page Down being used to advance to the next
  11. group, Page Up being used to regress to the previous group.
  12.  
  13. If the Save button is pressed, a filename may be entered and the currently
  14. visible icon will be saved into a file with the .ICO format.  You will be
  15. presented with a dialog box asking for a file name.  There will also be two
  16. radio buttons, one asking if you'd like to save the icon group, another
  17. asking if you'd like to save the individual icon.  While advancing through
  18. the icons, you may have noticed that some icons have the same name or number.
  19. These icons are called an icon group and, if the icon group radio button is
  20. enabled, all of these icons will be stored in the same file.  Such icon group
  21. files are used to adjust the icon for different devices.  Thus, using an icon
  22. group file will display a different icon based on whether the computer has a
  23. VGA, EGA, Monochrome, or CGA display.  All four of these device types will
  24. not always be represented in a group, so don't worry if you only see one or
  25. two icons with the same name or number.
  26.  
  27. If the Replace button is pressed, you will be presented with a dialog box
  28. containing an edit field filled with the name of the currently viewed
  29. icon.  If you wish to change the name or number of this icon, you may type
  30. what you wish in this edit field.  If the Cancel button is pressed at this
  31. time the name of the icon will NOT be changed.  If the OK button is 
  32. pressed the name of that icon will immediatly be changed in the file and
  33. you will be presented with a file selection dialog box.  This box contains a
  34. list of all files with the .ICO extension in your current directory, and a
  35. list of directories and drives to which you can also look.  Mr. Icon can also
  36. read files with the Windows BMP format and it will automatically convert the
  37. BMP file into the icon format and save the image into the file as an icon.
  38. After selecting a .ICO or .BMP file from this list, or typing a file name
  39. directly into the edit control above the file listbox, a dialog box will
  40. appear with a combo-box, an OK and a Cancel button.  If the arrow on the right
  41. side of the combo-box is pressed, a list of all icon formats in the .ICO file
  42. selected will be given.  By clicking on any of these formats, the list will disappear and the selected item will fill in the combo-box.  By pressing OK, the
  43. selected icon will replace the icon currently being viewed by Mr. Icon.  If
  44. the Cancel button is pressed, the currently viewed icon will NOT be changed.
  45. If a BMP file was selected as the file to be used, this box will not appear
  46. since bitmap files are only capable of storing a single image.
  47.  
  48. NOTE:  The facility to import BMP files will not check the dimensions of
  49.        the bitmap.  It is possible to have 64 x 64 pixel images used for
  50.        icons and I don't know if there are any limits beyond that.  The
  51.        dimensions normally used for icons in a windows program are as
  52.        follows (the following dimensions are in height x width):
  53.  
  54.        32 x 16, 2 color  - CGA
  55.        32 x 32, 2 color  - Monochrome
  56.        32 x 32, 8 color  - EGA
  57.        32 x 32, 16 color - VGA
  58.  
  59.        I have also tested the system using 64 x 64 pixel bitmaps in both
  60.        2 color and 16 color and both seem to have worked with the program
  61.        manager and with Windows in general.  Mr. Icon will not officially
  62.        support the use of dimensions other than these listed.
  63.  
  64.        The Paint program distributed with Windows 3.0 may save files in
  65.        the .BMP format and these files may be used with Mr. Icon.  In order
  66.        to make the job of editing easier what you may do is create a larger
  67.        bitmap and zoom into that bitmap.  Then create a 32 x 32 image and
  68.        use copy and paste to paste that 32 x 32 image into a 32 x 32 bitmap.
  69.  
  70. NOTE: Due to the fact that it would be an error to have more than one icon
  71.       for the same device format in a group, Mr. Icon will look at all icons
  72.       in the current group.  If the format of the icon selected for
  73.       replacement does not match the icon being replaced, but does match
  74.       the format of another icon in the group, that icon will not be
  75.       replaced.
  76.  
  77. If the Add button is pressed, you will be presented with a dialog box
  78. containing a list of all files with the .ICO extension in your current
  79. directory, and a list of directories and drives to which you can also look.
  80. Mr. Icon will also support the use of .BMP files as images to be added as
  81. icons.  In order to use a .BMP file merely type the file name and path
  82. directly into the File Open edit control, or type *.BMP in this edit control
  83. to get a list of all .BMP files.  Please read the NOTE: immediatly following
  84. the documentation on replace for more information.  If you press the Cancel
  85. button at this time, no icon will be added to the file.  If you select a .ICO 
  86. or .BMP file from this list and press the OK button, a dialog box will appear
  87. with an edit field asking for an ID number or ID name for the icon
  88. you will be adding.  This ID number or name will be the same ID or name you
  89. will see in the "Icon Name:" field of the icon information displayed by
  90. Mr. Icon.  When the OK button is pressed the cursor will change to an
  91. hourglass and there will be some disk activity as Mr. Icon readjusts the
  92. file and adds the icon (or icons if the .ICO file contains more than one image).
  93. If the Cancel button is pressed in the name dialog box, neither the icon nor
  94. the icon name will be added to the file.
  95.  
  96. NOTE: At this time, you can not add an icon to a program or DLL that
  97.       contains no resources.  Included with Mr. Icon is a DLL named
  98.       "emptydll.dll".  You may change this name to any name you desire.
  99.       If you wish to create a DLL with only your icons in it, merely
  100.       add an icon of your own and delete the icon currently contained
  101.       in the "emptydll.dll" file.
  102.  
  103. If the Delete button is pressed the cursor will change to an hourglass
  104. and there will be some disk activity as Mr. Icon readjusts the file to
  105. remove the icon (or icons if the icon chosen contains more than one
  106. image).
  107.  
  108. This program was created as a quick way to view and maintain icons in
  109. icon libraries (DLL's) available since the available tools (e.g. The Whitewater
  110. Resource Toolkit and Borland Resource Workshop) require somewhat more time to
  111. perform minor functions such as this.  This should offer an easy way to
  112. quickly extract only the icons that one wants and/or needs.  For more advanced
  113. manipulation or for the editing of icons, I would suggest purchasing one of
  114. the two tools mentioned previously.
  115.  
  116. Mr. Icon can be run from DOS.  An introduction screen will appear that gives
  117. a brief synopsis of the program.  Pressing 'r' at this screen will run
  118. Windows and Mr. Icon, provided that Windows is in the path someplace.
  119. Mr. Icon can also be run with a file name as a parameter.  So, if you want
  120. to look at the file "progman.exe" and you are in DOS, you can type:
  121.  
  122.    mricon progman.exe
  123.  
  124. at the DOS prompt and after the introduction screen is displayed merely
  125. press the 'r' key and Mr. Icon will run with progman.exe already open.
  126.  
  127. NOTE: Due to radically different formats, Windows Version 2.1 icons can not
  128.       be read by this utility.  Some programs may run under both Windows 2.1 and
  129.       Windows 3.0.  An example of this is WinWord.  Icons in such programs are
  130.       stored in Windows 2.1 format, and thus can not be read.  If a Windows 2.1
  131.       program is open by Mr. Icon, an error message will appear saying that
  132.       the file is in Windows 2.1 format.
  133.  
  134. NOTE: PLEASE MAKE BACKUPS OF YOUR PROGRAMS SINCE Mr. Icon DOES NOT MAKE
  135.       BACKUPS!
  136.  
  137.  
  138. ** Product registration information **
  139.  
  140. If you find this program interesting and would like to hear about future
  141. enhancements and/or tools please send $25 to:
  142.  
  143.    Patrick Deupree
  144.    Iseult Technology
  145.    4500 Sojourn, #2606
  146.    Addison, TX 75248
  147.  
  148. If you are using Mr. Bitmap and/or Mr. Cursor as well, a single $40
  149. registration fee will cover information on all three products.
  150.  
  151. Please mail any comments you might have to the above address or send me
  152. e-mail on CompuServe at user ID 76427,442.  I urge people to make
  153. comments and suggestions as that is the only way to truly see what people
  154. like and do not like about a product.
  155.  
  156.  
  157. ** Changes from Icon Extract/Icon Manager/Icon Librarian/Mr. Icon v1.0 **
  158.  
  159. Mr. Icon has gone through a few name changes since it was first written
  160. due to previously created programs by other shareware authors bearing
  161. the same name.  I apologize for any confusion that may have occurred due
  162. to the frequent name changes during the early months of this product.
  163. As of about late May, the name of this product has been Mr. Icon.  The
  164. functional changes between Icon Manager, Icon Librarian and Mr. Icon were
  165. minimal, so I will merely cover the general changes from these early versions
  166. to this current version.
  167.  
  168. Memory:   The original versions of Mr. Icon would load all icons read from a
  169.           file into memory.  This has now been changed.  The current mechanism
  170.           will only store the currently viewed icon in memory.  The minute
  171.           the next or previous buttons are pressed, the current icon will
  172.           be disposed of in memory and the next or previous icon will be
  173.           directly read from the file.
  174.  
  175. Speed:    The new Mr. Icon has a somewhat improved file adjustment mechanism
  176.           that makes replacement, addition and deletion somewhat faster than
  177.           they were or would have been before.
  178.  
  179. Features: The new Mr. Icon has four main features that were not present in
  180.           previous publicly released versions.  The first new feature is
  181.           the ability to change the name of the currently viewed icon in the
  182.           file.  The second is the ability to add icons to a file.  The
  183.           third is the ability to delete icons in a file.  More information
  184.           on each of these features may be found in the preceding section
  185.           telling how to use Mr. Icon.  The fourth new feature is the
  186.           ability to read .BMP files as well as .ICO files when replacing
  187.           or adding an icon.
  188.  
  189. Bugs:     The previous Mr. Icon did have a few bugs.  One of these was the
  190.           file open dialog box.  Previously, typing a file path directly into
  191.           the edit control above the file list box would not successfully
  192.           open the file.  In addition, trying to edit files on the root
  193.           directory of any drive caused a few problems.  All of these bugs
  194.           have been fixed.
  195.  
  196.           Another bug that existed previously involved opening more than one
  197.           session of the Mr. Icon program.  The square that actually displayed
  198.           the icon would exhibit some odd behavior (e.g. opening a second
  199.           session of Mr. Icon would cause the display area of the first
  200.           session to be filled with the second sessions icon).  This has
  201.           been fixed as well.
  202.  
  203.  
  204. ** Registration reminders **
  205.  
  206. I've not put an "automatic" about box or timed registration reminder in this
  207. program, the reason being I've always found such things annoying, most
  208. people ignore them, and it's a waste of time to write the code that does
  209. so.
  210.  
  211.  
  212. ** Development Tools **
  213.  
  214. You will notice that this program was created in two parts, one of which
  215. being a Dynamic Link Library.  The "ToolLib.DLL" file contains various
  216. code sets that perform the following actions:
  217.  
  218. resinfo: This contains functions oriented toward the following purposes:
  219.          Retrieving a list of all ID's within the file of a certain
  220.               resource type.
  221.          Adjusting the ID's of resources to accomodate insertion/deletion.
  222.          Retrieving data for a specific resource type and ID.
  223.          Modifying data for a specific resource type and ID.
  224.          Adding a resource to an file either before a specified ID
  225.               or at the end of the resources of that type.
  226.          Deleting data for a specific resource type and ID.
  227.  
  228.     bitmaps: This currently contains two major functions.  One will read
  229.              a .BMP file and return its file header information, and its
  230.              bitmap information.  The other will write a .BMP file given
  231.              just the bitmap information (the function will create the
  232.              file header based on information in the bitmap).
  233.  
  234.     icons:   This currently contains three major functions.  One will read
  235.              a .ICO file and return its file header information, and its
  236.              actual icon information.  The other two functions deal with
  237.              writing icons to a file.  One will save an icon group given
  238.              the icon header from an EXE file and a list of handles containing
  239.              the individual icons that are to be saved in the group.  The
  240.              other will save a single icon and create the icon file header
  241.              to accommodate that single icon.
  242.  
  243.     cursors: This currently contains two major functions.  One will read
  244.              a .CUR file and return its file header information, and its
  245.              actual cursor information.  The second function will save
  246.              cursor information to a file.  This function will create
  247.              the cursor file header for you and the cursor information is
  248.              expected in the same format as it is stored in an executable
  249.              file (that is, the cursor information is preceded by two
  250.              numbers representing the X and Y position of the hot-spot).
  251.  
  252.     bitview: This is a window class that will display a bitmap, cursor, or
  253.              icon of a size less than 64K.  If the item being displayed
  254.              is larger than the set space for the window, scroll bars will
  255.              appear automatically and all scrolling is handled by the
  256.              window class.
  257.  
  258.     names:   This is a set of functions used to manipulate the name table
  259.              of an EXE files resources.
  260.              This contains functions oriented toward the following purposes:
  261.              Addition of a name to the name table.
  262.              Deletion of a name from the name table.
  263.              Retrieval of a name given the items type and ID.
  264.              Comparison of a name, to find if it already exists in the table.
  265.  
  266.     Documentation for this DLL is available, though I've not yet set a
  267.     price for it.
  268.  
  269. In addition to these tool sets, I've created a DOS program that will extract
  270. Icon, Bitmap, and Cursor resources from an executable or resource file and
  271. will also display information on Dialog, Menu, and String entries (such
  272. as name, and info on menu items and controls such as item width, item ID, and
  273. item name).
  274.  
  275. The reason I mention these is that I would be interested in finding out how
  276. many people would like these tools.  I make no promises as to the
  277. availability of these tools as how much work I put into them depends on
  278. how much interest there is.
  279.